home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / prgtools / vtools21.zip / VTOOLS.HLP < prev    next >
Text File  |  1994-05-30  |  32KB  |  971 lines

  1. Click on a title:
  2. HELP ON HELP
  3. THE DESKTOP
  4. MEGASPRITES
  5. ANIMATOR
  6. ORGANIZER
  7. FRACTAL TREES
  8. WALLS
  9. MEGASPRITES DETAILED MANUAL
  10. The MegaSprites' screen
  11. Using the mouse in MegaSprites
  12. Selecting a color for brush, ellipse, fill area and others
  13. Drawing
  14. Editing
  15. Changing the palette
  16. To change a color in the whole drawing
  17. Painting and special effects
  18. Making a sprite
  19. Making a standard icon
  20. Making a sprite in ASCII files
  21. Viewing sprites in memory
  22. Summary of keyboard commands in MegaSprites
  23. FORMATS OF SPRITES
  24. FILE FORMATS
  25. PROBLEMS
  26.  
  27. HELP ON HELP
  28.  
  29. Change line     CURSOR UP/DOWN
  30. Change page     PAGE UP/DOWN
  31. Start of help   HOME
  32. End of help     END
  33. Close window    ESC
  34.  
  35.  
  36. THE DESKTOP
  37.  
  38. Each program of this software is represented by an icon and you
  39. also can see than icons are affected to each sprite file in the
  40. current directory, while they can fit in the available space on
  41. the screen... To click on an icon allows loading the file.
  42. One clicks once to put the cursor on an object, twice launch it.
  43. The two mouse buttons equally can be used on menu or on command
  44. icons. In other cases, they have not identical effect.
  45. In a general manner the left button is for a single  act  while
  46. the right button is for continuous act while held  down. Inside
  47. drawing windows they have not same function at all.
  48.  
  49. The title bar
  50.  
  51. The  desktop  shows  on  the  title bar the name of the current
  52. sprite  file. The button at right of the menu bar is similar to
  53. the  ESC  key  for  the mouse, and allows to exit a process, to
  54. close  a  window,  or to quit VTools. The button at left of the
  55. title  bar is for displaying copyright and current version.
  56.  
  57.  
  58. The menu bar
  59.  
  60. To  access menu, click on the menu bar or press ALT plus letter
  61. which is underlined. Use cursor keys to select an option (up/
  62. down) or change sub-menu (left/right).
  63. Press ESC to exit a sub-menu, press ESC again to exit the menu.
  64. Here  are detailed each function and its shortcut key.
  65.  
  66. FILE
  67. Load work      l       Load previously saved work
  68.                CTRL+l  Load work saved by CTRL+s
  69. Save work      s       Save table of sprites, addresses, types,
  70.                        automaton board.
  71.                CTRL+s  Save addresses and sprite images in
  72.                        separated files.
  73. Directory      d       Open the directory window.
  74. Set dir mask   x       Choose files to be displayed.
  75. Set path       Home    Set drive and access path.
  76. Load icon      i       Load a Window's icon.
  77. Quit           q       Exit VTools.
  78.  
  79. SPRITES
  80. MegaSprites    M       Sprite editor.
  81. Automaton      A       Automaton assembler.
  82. Organizer      O       Memory organizer.
  83. Virtual trees  F       Editor for virtual trees.
  84. Three-D view   T       Display sprites in 3D view.
  85. Display all    ?       Display sprites in memory.
  86.  
  87. PALETTE
  88. Change RGB      %      Change colors.
  89. Load pal+RGB    r      Load colors.
  90. Save pal+RGB    w      Save colors.
  91.  
  92. INFO
  93. Help            F1     Help screen.
  94. System          ~      Display formats, sizes, and so on...
  95. Internal        b      Display internal sprite buffer.
  96. Beeps on/off    -      Set/Reset sound.
  97. Colors          o      Dialog box for color preferences.
  98.  
  99. QUIT
  100. Quit           q       Exit VTools.
  101. Restart        y       Restart program with default values.
  102. Erase sprites  DEL     Erase all sprites in memory.
  103.  
  104. Other commands:
  105. ENTER: execute an icon.
  106. F3, ALT-x: Quit the program.
  107.  
  108.  
  109. Dialog box for confirmation
  110.  
  111. When  a box asks for a Y/N answer, press the left button inside
  112. the  box to respond 'Y', or click out of the box to say 'N' and
  113. cancel. Sometimes, for security, keyboard is required and mouse
  114. no allowed.
  115.  
  116.  
  117. The windows
  118.  
  119. Some windows can be moved and have variable size. In this case,
  120. there is a button at left on the title bar, with a 3D box insi-
  121. de.
  122. If  the window can be changed, press ALT-SPACE to enter editing
  123. mode,  and then use the cursor keys to move the window, or hold
  124. down  the ALT keys with the cursor keys to change the size.
  125. These keys +, -, <, > also allow to change the size.
  126. Press ENTER or ESC to exit editing mode.
  127.  
  128. Using a mouse, move it on the border of the window,  and  when
  129. the mouse image is changed, press left button and drag to move
  130. or change the size.
  131.  
  132. Press  the  right mouse button to exit the process, or click on
  133. the ESC button at the top of the screen.
  134.  
  135. To change the colors, press ALT-b for the background, ALT-h for
  136. the title bar.
  137.  
  138.  
  139. The directory
  140.  
  141. Press  'd' to display the current directory in a window.
  142. The filenames has black letters, and sub-directories red letters.
  143. Uses cursor keys or lift at right of the window to select a file
  144. and to scroll.
  145. Click on a drive icon or sub-directory to change it,  click   on
  146. '..' to return at previous level. Click  on  a  sprite filename
  147. (.SPR) or icon filename (.ICO) to load it.
  148.  
  149. To modify the window, press ALT-SPACE or click on borders.
  150.  
  151. Press ESC, or do a mouse click out of the window to close it.
  152.  
  153.  
  154. File masking
  155.  
  156. The  directory  display allows use of a combination of masks by
  157. file  type.  Press the 'x' key to open the dialogue box for the
  158. selection.
  159.  
  160. The types and extensions are as following:
  161. - Work:        Sprite files: SPR + WRK extensions.
  162. - Screens:     PCX, VRT, VGA files.
  163. - ICO:         Windows' icons.
  164. - All files:   All files recognized by VTools.
  165. - Directories: Sub-directories.
  166.  
  167. Click  on  the  1...5  button or type the number to set/reset a
  168. mask. The program says 'YES', when files will be displayed.
  169. Press HOME to restore defaults.
  170. Press ENTER to close, or press 'd' to show the directory now.
  171.  
  172.  
  173. To change drive and path
  174.  
  175. On  can set drive and path for files by a press on the 'p' key,
  176. and then by typing the drive letter and the path.
  177. Example:   A:\PIC
  178.  
  179.  
  180. Dialog box for loading and saving sprites
  181.  
  182. Loading  and  saving  are done with a dialogue box, opened when
  183. one  presses  'l' for loading, or 's' for saving (or CTRL-l and
  184. CTRL-s to have the adresses in a separated file).
  185.  
  186. In this program, only the filename node is read by the program,
  187. if an extension is typed the program removes it and replaces it
  188. with SPR and WRK extension to save or to load the file.
  189.  
  190.  
  191. The palette windows (RGB registers)
  192.  
  193. The % command opens the window for RGB registers changing, that
  194. don't  affect the desktop's colors but those of the sprite edi-
  195. tors only. There are two buttons to select the previous or next
  196. colors and three bar to change the RGB registers.
  197. The registers are temporary affected to the color 9.
  198.  
  199.  
  200. The dialog box for colors
  201.  
  202. To  select  an item to change, use the vertical cursor keys. To
  203. select the color, use the horizontal cursor keys.
  204. Colors of some windows may be changed with the ALT-b key for the
  205. background and ALT-h for the title bar, when the window is opened.
  206. These color are saved with the file of sprites.
  207.  
  208.  
  209. MEGASPRITES
  210.  
  211. BRUSH MOVE      Numeric keypad
  212. COLOR           Cursor keys
  213. BRUSH UP/DOWN   Space bar
  214. BIG BRUSH       .
  215. RUBBER ON/OFF   0
  216. CLEAR DRAWING   DEL
  217. UNDO            u
  218. SELECT SPRITE   PAGE UP/DOWN
  219. GET SPRITE      g
  220. MAKE SPRITE     b  256 colors
  221.                 k  16 colors
  222.                 z  Packed
  223. MAKE ICON       i
  224. MAKE ASC IMAGE  j
  225.  
  226. REPLACE COLOR   c  then ENTER
  227. LINE            l
  228. RECTANGLE       r
  229. ELLIPSE         e
  230. REVERSE         ] Horizontal
  231.                 ~ Vertical
  232. SPRAY           s
  233. FILL AREA       f
  234. SHADING         a     from left
  235.                 ALT-a from rigth
  236.  
  237. CUT & PASTE     /
  238.                 Tab change window
  239.                 Enter to paste
  240.                 Enter to keep
  241. MERGE ONLY      @
  242. MERGE & ROTATE  *
  243. INSERT ROW      CTRL-r
  244.        COLUMN   CTRL-o
  245. DELETE ROW      CTRL-y
  246.        COLUMN   CTRL-w
  247. SIZE            < >  Width
  248.                 - +  Heigth
  249. SCALE           w    Then:
  250.                 g   to keep
  251.                 Del to cancel
  252. SET ANGLE       F7          -1
  253.                 CTRL-F7     -10
  254.                 ALT-F7      -90
  255.                 F8          +1
  256.                 CTRL-F8     +10
  257.                 ALT-F8      +90
  258.                 Angle will be used
  259.                 when merging sprite
  260.  
  261. CHANGE PALETTE  red:   ALT-r  R
  262.                 green: ALT-g  G
  263.                 blue:  ALT-b  B
  264.  
  265. QUIT to desktop   ESC
  266. QUIT to tree      F
  267.         organizer O
  268.         animator  A
  269.         3D        T
  270.  
  271.  
  272. MOUSE
  273.  
  274. In the drawing window:
  275. PUT CURSOR      Click right button
  276. DRAW            Hold down left button
  277.  
  278. In the zoomed window:
  279. GET COLOR       Click right button
  280. DRAW            Hold down left button
  281.  
  282.  
  283. MEGASPRITES DETAILED MANUAL
  284. (Read it from the desktop)
  285.  
  286. The MegaSprites' screen
  287.  
  288.            Zoomed       Palette for 16 color sprites
  289.            drawing         Inks for color making
  290.  
  291. Sprites    Normal
  292.   in       sized         256 color palette
  293. Memory     drawing
  294.  
  295. Width and height of the sprite are displayed below the image.
  296. Number of the in sprite in the table is below this window and
  297. available free space in memory is below the grey icons, that are
  298. for special effects.
  299. Below the inks for color creating are indicators:
  300. -  at  left  the indicator for the brush up or down, nothing if
  301. brush is up and a filled rectangle if brush is down.
  302. - then is the rubber if rubber is on, otherwise nothing.
  303. - at right a triangle is shown when one gets a color to copy it
  304. elsewhere  in  the  palette, or there are two filled rectangles
  305. when one does a color change in the image.
  306.  
  307. There are icons for the ten most usual functions:
  308.  
  309. #1 get image from the memory to the drawing window.
  310. #2 clear the drawing.
  311. #3 filling.
  312. #4 the  rabbit  and  the  hat,  symbolize the 'undo' function,
  313.    that comes back to past and restore image as before last act.
  314. #5 cut and paste.
  315. #6 change a color in the whole image.
  316. #7 make a 32 x 32 icon from the image.
  317. #8 make a 256 colors sprite from the image.
  318. #9 make a compressed 16 colors sprite.
  319. #10 return to the desktop.
  320.  
  321. There  is  also  a  panel  for special effects or other drawing
  322. function:  shading,  rotating, brush width, ellipse, line, rec-
  323. tangle, spray...
  324.  
  325.  
  326. Using the mouse in MegaSprites
  327.  
  328. In the central window:
  329. - press left button to draw. Click once or hold down it to paint.
  330. - press right button to put the cursor at a location.
  331.  
  332. In the upper magnifying window:
  333. - press left button to draw.
  334. - press  right  button  to  get a color from the drawing.
  335.  
  336. In the left window on memory:
  337. - press left button to view next sprite.
  338. - press right button to view the previous one.
  339.  
  340. In the palette area:
  341. press any mouse button to get the color.
  342.  
  343. On the bar of icons:
  344. press any mouse button to execute the command.
  345.  
  346.  
  347. Selecting a color for brush, ellipse, fill area and others
  348.  
  349. Use  cursor  keys  to move both in the 256 color palette and in
  350. the 16 color palette, or click on a color. The current color is
  351. designated by a rectangle above the palette.
  352.  
  353.  
  354. Drawing
  355.  
  356. First  put  the  brush  down  by a press on the space bar. When
  357. brush  is  down  a rectangle of current color appears above the
  358. palette.  In the same manners, the rubber is set on or off by a
  359. press on the '0' key.
  360. Use the numeric keypad to move the cursor on the drawing, or to
  361. draw if the brush or the rubber is down.
  362.  
  363. One can double the size of the brush by a press on the '.' key.
  364.  
  365.  
  366. Editing
  367.  
  368. To edit the image, use these keys:
  369. CTRL-r   Insert a row of pixels at cursor location.
  370. CTRL-y   Delete the row.
  371. CTRL-o   Insert a column.
  372. CTRL-w   Delete the column.
  373.  
  374. <     reduce width (20 pixels min.).
  375. >     increase width (80 pixels max.).
  376. -     reduce height (20 pixels min.).
  377. +     increase height (80 pixels max.).
  378.  
  379. Mirror functions:
  380. ] or [   horizontal mirror.
  381. ~        vertical mirror.
  382.  
  383. Undo:
  384. One level undo is provided, type 'u' to restore the image. That
  385. clears the result of any function having general effect. It's
  386. easy to save the image (with the 'b' command), get it, remove
  387. an useless sprite with the organizer.
  388.  
  389. Clearing the window:
  390.  
  391. Type CTRL-z or DEL.
  392.  
  393.  
  394. Changing the palette
  395.  
  396. You  can  move  a  color from a number to another... Press 'o',
  397. this holds the current selected color, a triangle appears above
  398. the  palette,  move  now to a new location and press 'o' again,
  399. this drop the color and the triangle disappears.
  400.  
  401. You may change basis components of a color to create one...
  402. Click on the basis components above the palette, with the left
  403. button to add to, the  right button to reduce an ink.
  404. With the keyboard, press R, G, B (uppercases) to add ink to the
  405. color, press ALT+r, ALT+g or ALT+b to reduce it.
  406.  
  407. The  palette  you create must allow inversion of color for some
  408. drawing  function, this supposes colors with complementary num-
  409. ber  (=complementary position in the palette) also have comple-
  410. mentary display, so complementary of a clear color must be dark
  411. and conversely...
  412.  
  413. The  palette  is saved in the WRK file, when sprites are saved,
  414. or separately with the 'w' command at the desktop.
  415.  
  416.  
  417. To change a color in the whole drawing
  418.  
  419. This changes all pixels of a color to another color.
  420. Move the brush on a pixel having the color to be changed in the
  421. image, and then select a color in the palette for the replacing
  422. color, then  press 'c' to do the change.
  423. The  two  colors, are displayed above the palette. At left, the
  424. previous one, at right the new one.
  425. You may again change the colors with cursor: up and down for the
  426. previous, left and right for the new.
  427. Press ENTER to do the change.
  428.  
  429. With mouse, one selects the icon #5, one gets if needed old co-
  430. lor  with  left  button,  new  color  with right button and one
  431. clicks again on icon #5 to do the change.
  432.  
  433.  
  434. Painting and special effects
  435.  
  436. FILLING
  437. Select  first  the color, set the brush up, move the cursor in-
  438. side the area to fill, set the brush down, press 'f'.
  439.  
  440. Using mouse:
  441. 1) first get a color,
  442. 2)  set  the location inside the drawing, with right mouse but-
  443. ton.
  444. 3) click on the fill icon, the third.
  445.  
  446.  
  447. ELLIPSE/CIRCLE, RECTANGLE, LINE
  448. Select first the color for the object to draw.
  449. Type
  450. - 'e' to draw an ellipse or a circle,
  451. - 'r' for a rectangle,
  452. - 'l' for a line.
  453.  
  454. To  move the object, use the cursor keys or the left mouse but-
  455. ton.
  456. To  change  the  size,  use  the '4', '6', '8', '2' keys or the
  457. right mouse button. If a line, this changes the ending point.
  458.  
  459. Type  ENTER to draw the object according to the selected color,
  460. or  press  ESC  to  cancel. For the mouse, the get icon does an
  461. ENTER press.
  462.  
  463. SPRAY
  464. Press 's' or click on the spray icon, the mouse pointer becomes
  465. a spray and so remains until you press again on the spray icon.
  466.  
  467. SHADING
  468. -  choose  a row in the palette, it will be displayed at top in
  469. the 16 colors palette... The standard palette has at second row
  470. a  gray  gradation that is a good example for the shading func-
  471. tion.
  472. - move the cursor on a color in the image.
  473. -  press  'a'.  All areas with the chosen color have now grada-
  474. tion, according to the row of the palette...
  475. - press ALT-a to do shading from right to left.
  476.  
  477. SCALE
  478. Press 'w', then the < >  + keys to change the size. Press ENTER
  479. or click on the 'get' icon. The 'del' icon replaces ESC.
  480.  
  481. MERGING IMAGES
  482. Press the '@' key to put the sprite in memory over the drawing.
  483. Press  the  '*'  key to do it according to the current rotation
  484. angle,  value of which being displayed below the window of dra-
  485. wing, at right.
  486.  
  487. To change this angle, type:
  488. F8               1 degree right.
  489. CTRL-F8          10 degrees right.
  490. ALT-F8           90 degrees right.
  491. F7               1 degree left.
  492. CTRL-F7          10 degrees left.
  493. ALT-F7           90 degrees left.
  494.  
  495.  
  496. CUT & PASTE
  497. This function is similar to the previous one, but it works with
  498. a part of the drawing, or a part of the sprite in memory.
  499. Press  '/' . A rectangle is outlined upon the sprite in memory.
  500. Press  the  TAB  key  to cut into the image or to return on the
  501. sprite in memory.
  502.  
  503. Use  <, >, +, - to change size, and the cursor keys to move the
  504. outlined rectangle.
  505. Or put left mouse button down and drag to move and right button
  506. to change size.
  507. Now press ENTER or click on the first icon at bottom of screen.
  508. The  cut  part of the image is now displayed inside the drawing
  509. window, by inverting the colors...
  510. Remember  than  if colors are not complementary in the palette,
  511. you see nothing.
  512.  
  513. Now you can change the angle of rotation if you want.
  514. - press a key of the numeric pad.
  515. - or press +, - to change a single degree.
  516. - or press < or > to change 10 degrees.
  517. - or use same keys as for the previous function.
  518. With  mouse, click on the icons that represent curved arrows at
  519. left, to change the angle.
  520.  
  521. The  cursor  keys  or the left mouse button held down, allow to
  522. move the part of image.
  523.  
  524. Press  ENTER  to paste or click on the icon #1 at the bottom of
  525. screen.
  526.  
  527.  
  528. Making a sprite
  529.  
  530. Various  kind  of sprites can be made from drawing according to
  531. following commands:
  532.  
  533. b         256 colors sprite.
  534. z         Z-RLE compressed 16 colors sprite.
  535. k         16 colors sprite (Size in memory is reduced by half
  536.           in relation to 256 colors sprite). As above, but no
  537.           compressed.
  538.  
  539. When  making  any  16 color sprite or icon, the image must have
  540. colors  of  a same row in the palette. The sprite has colors of
  541. the  row of palette you select at the time you made it, not the
  542. colors  you  use  when drawing it... The first color in this 16
  543. colors palette is always the black background color.
  544.  
  545. A  16  colors  sprite  must  have even number of columns as two
  546. pixels  are  stored into one byte. The program sets the correct
  547. number of columns if needed.
  548.  
  549.  
  550. Making a standard icon
  551.  
  552. When you want to create an icon for Windows, you must first set
  553. the proper 32 x 32 pixels size.
  554. Use  the  '<'  key  to  reduce  the width and '-' to reduce the
  555. height, then draw the image.
  556. The  black  color is a part of the displayed image, to make the
  557. background,  use any color that is not in the first row at bot-
  558. tom of the palette.
  559. To  create the ICO file, press 'i', then give a 8 letters name,
  560. without extension, and press ENTER.
  561. The  image will also be stored as a sprite to be further edited.
  562.  
  563.  
  564. Making a sprite in ASCII file
  565.  
  566. Type  'j'  and  give  a  8 letters name, without extension, and
  567. press ENTER.
  568. The  program will create a text file having ASC extension, that
  569. holds a 16 color sprite, that you may insert directly into your
  570. programs.  The  syntax  of the array is for the C language, but
  571. you may be easily edit it to another one.
  572. This command also add a sprite in memory.
  573.  
  574.  
  575. Viewing sprites in memory
  576.  
  577. The  window  at  left shows sprites in memory, one uses PAGE UP
  578. and PAGE DOWN to select next or previous one in memory.  Or one
  579. puts  the  mouse  pointer into this window and presses the left
  580. button  to view the next sprite or the right button to view the
  581. previous one.
  582.  
  583. Type  'g'  to copy the sprite from memory to the window of dra-
  584. wing.
  585. To  compare  the  images,  type @ to put one over the other and
  586. type u to restore the drawing.
  587. The Organizer displays full description of each sprite in memo-
  588. ry.
  589.  
  590.  
  591.  
  592. ANIMATOR
  593.  
  594. Summary of commands:
  595.  
  596. F1      This help screen.
  597. PAGES   Select a sprite in memory.
  598. Cursor keys Move to a location on the board.
  599. 0..9    Put a symbol at cursor location.
  600. ENTER   Put an ellipse on the board.
  601. DEL     Erase current cursor position
  602. x       Clear the whole board.
  603. i       Interpret the automaton and animate it. Move first
  604.         the cursor at start of the sequence.
  605. z       Run the automaton in VGA 19, 256 colors.
  606. m       Execute step by step the automaton.
  607. r       Read an automaton, displays it starting at current
  608.         cursor position.
  609. w       Write an automaton in a file, starting at cursor.
  610. #       Put/Remove the grid.
  611. n       Refresh the screen.
  612. HOME    Go to the start of the board.
  613. END     Go to the end of the board
  614. <       Scroll the board 20 columns left.
  615. >       Scroll the board 20 columns right.
  616. +       Slow down the animation.
  617. -       Speed up the animation.
  618. p       Switch between editor palette or standard one.
  619. ALT-b   Change the panel command color.
  620. ALT-j   Change the board color.
  621. ALT-n   Change the text and line color.
  622. ALT-o   Change the border.
  623. O       Organiser.
  624. M       MegaSprites.
  625. T       Three-D viewer.
  626. F       Virtual tree editor.
  627. q       Return to desktop.
  628.  
  629. MOUSE ON THE COMMAND PANEL
  630. Click on a symbol to get a link.
  631. Click anywhere to drop it and get the current sprite number.
  632.  
  633. MOUSE ON THE ASSEMBLY BOARD
  634. The mouse becomes a pencil when holding a sprite number and
  635. a cross when holding a symbol.
  636. Press the left button to put link or sprite number, and the
  637. right button to move the cursor at mouse pointer
  638.  
  639. Detailed manual
  640.  
  641. This program allows to make automatons that are sequences  of
  642. sprites that composes an animation.
  643. On the board, an automaton is a sequence of ellipses  with
  644. number of sprites inside them, ordered by arrows.
  645.  
  646. Animation  can  be  shown  in  the  window at the middle of the
  647. screen, or in full screen with VGA 19. At right of this window,
  648. nine  symbol  represent different available links. At right are
  649. shown the sprites in memory.
  650.  
  651. To  execute  a  sequence,  press  'i' or 'z' to view it in full
  652. screen.  The interpreter reads on the board from left to right.
  653. It  can  go up or down, but it respects following priorities if
  654. several  arrows  start  of  the  same  ellipse: right, then up,
  655. otherwise down.
  656.  
  657.  
  658. Making and editing automaton
  659.  
  660. One  selects a sprite in memory with PAGE UP/DOWN keys, and one
  661. presses ENTER to put an ellipse at cursor location, holding its
  662. number.
  663.  
  664. The keys to put arrows are these:
  665. 0: a horizontal line, the symbol to go right.
  666. 5: a vertical line, to go up or down.
  667. 1, 3, 7, 9: symbols to change direction.
  668. 2,  6, 8: add '>' to the lines, that is for better comprehensi-
  669. bility but have no utility for the interpreter.
  670.  
  671. The DEL key erases an ellipse.
  672.  
  673. To  save an automaton, move the cursor at the first ellipse and
  674. press  'w'. To load it, move the cursor at a location and press
  675. 'r'.
  676.  
  677. To change the sprite, click on the PAGE UP/DOWN keys at left of
  678. sprite  in  memory, with left button to scroll one at the time,
  679. right button to a fast scroll.
  680.  
  681. The horizontal lift allows to scroll the board of automatons.
  682.  
  683. Automatons  are saved in files with the AUT extension, that the
  684. program adds to itself. The board is saved into the WRK file.
  685.  
  686.  
  687. ORGANIZER
  688.  
  689. This  utility  allows to change order of sprites in memory, de-
  690. lete  one, convert the format, display the detailed description
  691. and test the integrity.
  692.  
  693. Icons
  694.  
  695. CNVRT   Convert selected sprite to selected format.
  696. ENTER/ESCAPE  Replace the Enter and Esc keys.
  697.  
  698. Keyboard commands of the organiser
  699.  
  700. PAGES   Select a sprite in memory.
  701. HOME    Go to the first sprite in memory.
  702. END     Go to the last sprite in memory.
  703. m       Go to the move mode. Use PAGE UP/DOWN to select a
  704.         new location, press ENTER to move or ESC to cancel.
  705. DEL     Delete displayed sprite.
  706. t       Change current format for converting.
  707. !       Convert displayed sprite to current format, and
  708.         replace it.
  709. b       Display x 4 a Z-RLE sprite.
  710. z       Display on VGA 19 screen, if format is compatible.
  711. p       Switch between editor palette or standard one.
  712. A       Assembler.
  713. M       MegaSprites.
  714. T       Three-D Viewer.
  715. F       Virtual Tree Editor.
  716. Q, ESC  Return to desktop.
  717.  
  718.  
  719. FRACTAL TREES
  720.  
  721. This  program  mathematically calculate form of trees and paint
  722. them on the screen.
  723. Their parameters are saved in a 16 bytes file that the user can
  724. display, with the tree function, in its programs.
  725.  
  726. In  the  editor, there are commands to change sizes and command
  727. to change characteristics of trees.
  728. In  a general manner, one use lowercases to reduce a parameter,
  729. and uppercases to increase it, for command that have a horizon-
  730. tal lift on the panel.
  731.  
  732. Press F1 for help screen.
  733. Press ? to know numerical values of parameters.
  734. To speed up the changes on bars, type a number, from 1 to 9.
  735.  
  736. Commands for sizes:
  737. s     size of the whole tree.
  738. r     random number to determine the whole tree.
  739. t     height of the trunk.
  740. u     length of the branches.
  741. w     width of trunk and branches.
  742.  
  743. Commands for characteristics:
  744. l     drawing leaves or not.
  745. b     branching or not for the trunk.
  746. m     multiple branches at same level or not.
  747. h     straight trunk or not.
  748. f     fractal characteristic: branches have same
  749.       form than the trunk.
  750. c     conical form.
  751.  
  752. The  trunk can be gray or brown (n), leaves are green or snowed
  753. (v).
  754.  
  755. To  save  parameters,  type  'p', then give a name, the program
  756. adds  to the TRE extension. To load a tree, press 'g' and gives
  757. the name without extension.
  758.  
  759.  
  760. WALLS
  761.  
  762. This  utility allows  to display the objects you create with
  763. MegaSprites with a three-d view.
  764.  
  765. The  bar of icons at bottom display these function from left to
  766. right:
  767. #1   Set the corridor view.
  768. #2   Set the front wall view.
  769. #3   Get the previous image.
  770. #4   Get the next image.
  771. #5-8 Change the size.
  772. #9   Go to MegaSprites.
  773. #10  Return to the desktop.
  774.  
  775. Above  the  bar  of icon is an indicator that shows if the view
  776. display an image or only the structure of scenery.
  777. If  you  wish  to change the size of the scenery, set first the
  778. view  to  the green lines for faster display. That be done by a
  779. click on the indicator.
  780.  
  781. Keyboard commands:
  782.  
  783. g         Get the image to the view.
  784. DEL       Remove the image from the view.
  785. e         Set the corridor view.
  786. f         Set the front panel view.
  787. PAGE UP   Next image.
  788. PAGE DOWN Previous image.
  789. <         Reduce the width.
  790. >         Increase the width.
  791. -         Reduce the height.
  792. +         Increase the height.
  793. M         Go to MegaSprites.
  794. ESC       Return to the desktop.
  795.  
  796.  
  797. FORMATS FOR SPRITES
  798.  
  799. All  formats  but  MS are for displaying sprites from bottom to
  800. top of screen.
  801. Coordinate of sprite, but special F and EAS, are
  802. - 0..639 x 0..479 on VGA 18 and SVGA,
  803. - 0..319 x 0..199 on VGA 19.
  804. Size  is  limited only by editors, 80 x 80 with MegaSprites and
  805. VGA 18 sprite editor, 320 x 200 with Screen Maker.
  806.  
  807. Encoding  use  either  bitmap: 16, 256, Z16 or bit planes: F16,
  808. MS,  EAS.  Bit planes encoding displays very fast on VGA 18 (or
  809. VGA  16-EGA) screen resolution. Bitmap is an universal encoding
  810. that displays on MCGA, VGA, SVGA with appropriate functions.
  811. Principle of bitmap is to store all bits of a pixel into a byte
  812. of  memory,  while  bit  planes encoding stores image by screen
  813. planes.
  814.  
  815.  
  816. The 256 colors format.
  817.  
  818. It's  a  universal  format  to display sprites with all VGA and
  819. SVGA screen modes. Each pixel is coded with one byte, according
  820. to the bitmap encoding.
  821. In VGA 19 these sprites can be displayed very fast.
  822.  
  823.  Header:
  824.  Byte 0: height, from 1 to 200.
  825.  Byte 1: unused
  826.  Byte 2-3: width from 1 to 320.
  827.  Byte 4: format code 1.
  828.  Byte 5: unused
  829.  
  830.  
  831. The 16 colors format.
  832.  
  833. A universal format for VGA and SVGA. No compressed. The palette
  834. number  allows  on  256 color screen to display the same sprite
  835. with  different  sets of colors. It uses bitmap encoding with a
  836. byte holding two pixels.
  837.  
  838.  Header:
  839.  Byte 0:   height, from 1 to 200.
  840.  Byte 1:   unused
  841.  Byte 2-3: width from 1 to 320.
  842.  Byte 4:   format code 5.
  843.  Byte 5:   palette row number.
  844.  
  845. The 16 colors Z-RLE format.
  846.  
  847. A universal format for VGA and SVGA. Image is coded with an RLE
  848. compression  algorithm  that  allows  a  display with same fast
  849. speed than no compressed sprite. Compression can divide size by
  850. 5  or  more,  depending of complexity of the image. The palette
  851. number allows on 256 color screen to display a same sprite with
  852. different sets of colors. Use bitmap encoding.
  853.  
  854. Header: as above, with format code 4.
  855.  
  856. The F16 (fast) format.
  857.  
  858. It  is  a  format  for VGA 18, that displays sprites very fast,
  859. with  no  boundary,  so horizontal coordinate is in range 0..79
  860. and not 0..639. Use bit planes encoding.
  861.  
  862.  Header:
  863.  Byte 0:   height, from 1 to 200.
  864.  Byte 1:   unused
  865.  Byte 2-3: width from 1 to 80.
  866.  Byte 4:   format code 6.
  867.  Byte 5:   unused.
  868.  
  869. The EAS (Easy) format.
  870.  
  871. This  format  allows  to  make  sprite  with variable number of
  872. screen  pages, from 1 to 4, and so displaying animation without
  873. erasing background. Uses bit planes encoding.
  874.  Header:
  875.  Byte 0:   height, from 1 to 200.
  876.  Byte 1:   unused
  877.  Byte 2-3: width from 1 to 80.
  878.  Byte 4:   format code 3.
  879.  Byte 5:   unused.
  880.  
  881.  
  882. MS
  883.  
  884. Format to display sprites from top to bottom of screen. It uses
  885. bit planes encoding.
  886.  Header:
  887.  Byte 0: height, from 1 to 200.
  888.  Byte 1: unused
  889.  Byte 2-3: width from 1 to 320.
  890.  Byte 4: format code 2.
  891.  Byte 5: unused.
  892.  
  893.  
  894. Icons.
  895.  
  896. When  icons are packed in a single file, they use the 256 or 16
  897. colors format or compressed Z-RLE format.
  898. They also can be saved into an ICO file with Windows' format.
  899. Functions of the library in the registered version that display
  900. icons  use  color 9 as background color and don't put it on the
  901. screen, that is for rather display the 0 color that corresponds
  902. to the more useful black color.
  903.  
  904.  
  905. FILE FORMATS
  906.  
  907. Extensions  are  entirely managed by the program. If user gives
  908. an  extension when asked for a filename, the program removes it
  909. and puts the proper extension. Each type of file has its proper
  910. extension.
  911.  
  912. SPR  Sprite table. Can hold relative addresses of sprites, or
  913.      no.
  914. WRK  Work file, it is created when saving sprites and it holds
  915.      preferences, palette, board of automatons.
  916. ADR  Addresses of sprites in the table. Generated by a CTRL-s.
  917. PCX  Picture file, the standard format.
  918. VRT  Picture file, more compressed format with fast display.
  919. VGA  Picture file with no header, no compressed.
  920. PAL  Palette. Bytes 0 to 767 are RGB registers, byte 768 is
  921.      unused, bytes 769..784 for colors 0..15  of the VGA 18
  922.       palette.
  923. AUT  Automaton. Each sprite number use two bytes. Bytes 0 et 1
  924.      of the file hold the number of sprites.
  925. TRE  Tree file, holds 12 parameters, one byte each.
  926. ICO  Standard Windows' (c) icon file.
  927. ASC  Sprite saved as ASCII file.
  928.  
  929.  
  930. PROBLEMS
  931.  
  932. UNDO exists. Type 'u' to restore image as before the last act.
  933.  
  934. BLACK SCREEN
  935. If  you  load a previous work and the WRK file has been corrup-
  936. ted,  the  color  registers  can be erased, type 'y' to restore
  937. standard palette, or load a previously saved palette.
  938.  
  939. NO ELLIPSE, RECTANGLE, LINE, PASTE...
  940. The  ellipse  starts with color complementary to background co-
  941. lor, if background has color 0, and is black, complementary co-
  942. lor is 255, and if it is black also, you see nothing. This pro-
  943. blem  disappears by making a palette with complementary colors,
  944. that is generally the case when using gradation.
  945.  
  946. COLORS OF SPRITE...
  947. Remember than when ones makes a 16 colors sprite with MegaSpri-
  948. tes,  colors  of  the sprites are those or current 16 color pa-
  949. lette (at top of screen), not colors used when drawing. This is
  950. a voluntary feature that allows to use different sets of colors
  951. with a same drawing...
  952.  
  953. WIDTH OF SPRITES...
  954. The  16 color sprites must have even width. The program automa-
  955. tically corrects that and add a column if needed.
  956.  
  957. WORK CAN'T BE LOADED
  958. This  can occurs if you save sprites with CTRL-s (addresses and
  959. raw  data  in separated files) and then load file with 'l' (ad-
  960. dresses  and  raw  data  in same file). Remember 'l' matches s,
  961. CTRL-l matches CTRL-s.
  962. The  memory  buffer for the table of sprites has variable size,
  963. that  depends  of  the  available conventional memory, 640Kb or
  964. less. By adding resident program it may occurs the memory buffer
  965. has too reduced to load a file of sprites.
  966.  
  967. CTRL-c  The control-c interrupt is disabled, however some mouse
  968. drivers can thwart that, so try to avoid type that.
  969.  
  970.  
  971.